home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / pcopy51.arc / PCOPY.DOC < prev    next >
Text File  |  1986-11-05  |  27KB  |  721 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                             P C O P Y   /   P M O V E
  17.  
  18.                                        by
  19.  
  20.                                  Norm Patriquin
  21.  
  22.  
  23.  
  24.                                    Version 5.1
  25.                                   November 1986
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                        Copyright 1986 by Norm Patriquin
  34.  
  35.  
  36.  
  37.                         Table of Contents
  38.  
  39.  
  40.       What is PCOPY . . . . . . . . . . . . . . . . . . . . . .   1
  41.       What is PMOVE . . . . . . . . . . . . . . . . . . . . . .   1
  42.       About PCOPY . . . . . . . . . . . . . . . . . . . . . . .   2
  43.       Features  . . . . . . . . . . . . . . . . . . . . . . . .   3
  44.       Command Mode Parameters . . . . . . . . . . . . . . . . .   5
  45.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .  11
  46.       Registering PCOPY . . . . . . . . . . . . . . . . . . . .  12
  47.       Registration Form . . . . . . . . . . . . . . . . . . . .  13
  48.       Problems and Maintenance. . . . . . . . . . . . . . . . .  14
  49.       Other Utilities . . . . . . . . . . . . . . . . . . . . .  16
  50.                                                                 Page  1
  51.  
  52.       What is PCOPY
  53.       -------------
  54.  
  55.       PCOPY is a DOS command utility used to copy files between disks
  56.       and directories on disks.  In addition to just copying files,
  57.       PCOPY also allows selection criteria to be specified to better
  58.       qualify the files to be copied.
  59.  
  60.       PCOPY provides a safer way to copy files than is provided by
  61.       the DOS COPY command.  It warns you if a file is about to be
  62.       overlayed and lets you have complete control over the copy
  63.       operation.
  64.  
  65.  
  66.       What is PMOVE
  67.       -------------
  68.  
  69.       PMOVE is a DOS command utility used to move files between
  70.       disks and directories on disks.  PMOVE combines the functions
  71.       of DOS COPY and DELETE commands to make make moving files
  72.       very easy.  In addition to just moving files, PMOVE also
  73.       allows selection criteria to be specified to better qualify
  74.       the files to be moved.
  75.  
  76.       PMOVE automatically determines the environment the move is
  77.       requested for and then determines if the data must be moved
  78.       or if the file can be moved by renaming.  Moving with rename
  79.       is allowed if the move is to another directory on the same
  80.       disk device.  If a rename move can be done, it is much faster
  81.       than moving the data, it helps to keep from fragmenting disk
  82.       free space, and allows very large files to be moved between
  83.       directories when they could not normally be moved with DOS
  84.       COPY because of insufficient space.
  85.  
  86.       In this implementation, PMOVE is implemented as a DOS batch
  87.       command file that uses PCOPY with the /X parameter.  If you
  88.       register PCOPY and ask for the complete utility disk you
  89.       will have two separate programs, PMOVE and PCOPY.  For the
  90.       remaining part of this documentation we will refer to the
  91.       program as PCOPY. Remember that the only difference between
  92.       PCOPY and PMOVE is that PMOVE removes the file from the
  93.       source location after it has been sucessfully copied to the
  94.       desired location.
  95.                                                                 Page  2
  96.  
  97.  
  98.       About PCOPY
  99.       -----------
  100.  
  101.       PCOPY is developed to allow standard DOS wildcard pathnames
  102.       in the source file specifications, and standard pathnames
  103.       for the target directory specification.  Wildcards are not
  104.       allowed for the target path specification.
  105.  
  106.       PCOPY attempts to anticipate your needs and help you accomplish
  107.       your task.  For instance, if PMOVE determines that the target
  108.       directory name does not exist, it will ask you if it is to be
  109.       created.  If you respond <YES>, the directory will be created
  110.       for you.  With the /SAve option,  if you are about to overlay
  111.       another file with a duplicate name, you will be asked if the
  112.       older duplicate file is to be renamed with a version number.
  113.  
  114.       PCOPY keeps you out of trouble.  If it saves you from
  115.       overlaying a needed file just once it has paid for itself.
  116.       Think of all the times it might have saved you in the past.
  117.  
  118.       I have tried to develop PCOPY with all the features normally
  119.       needed for this kind of utility.  I hope you find what you
  120.       need and that the utility is of use to you.
  121.  
  122.       For an immediate command summary, enter the PCOPY command without
  123.       any parameters.  Help panels will be displayed.
  124.  
  125.  
  126.                                                                 Page  3
  127.       Features:
  128.       ---------
  129.  
  130.         **  Copies files to and from any disk or directory.
  131.  
  132.         **  Allows you to save older versions of files with new
  133.             names before replacing them.
  134.  
  135.         **  Moves files by copying them or renaming them to the new
  136.             location.
  137.  
  138.         **  Deletes the original file if /X is specified.
  139.  
  140.         **  Creates target directorys if needed.
  141.  
  142.         **  Makes sure the DOS archive flag is set correctly for each
  143.             file as it is moved.
  144.  
  145.         **  Preserves the DOS date and time for each file moved.
  146.  
  147.         **  Allows user to pause processing at any time by pressing any
  148.             keyboard key.  Once stopped, the program can be terminated
  149.             by pressing <ESCAPE>.
  150.  
  151.         **  Provides file selection and processing control options
  152.             to tailor the move process to your own needs.
  153.  
  154.         **  Allows commands to be tested so you may be sure
  155.             that commands are specified as you desire.
  156.  
  157.         **  Copy updated files to a special disk or directory.
  158.  
  159.         **  If there is not sufficient space on the current target
  160.             disk, PMOVE will allow you to place another disk in the
  161.             drive and continue processing.  This allows you to easily
  162.             move groups of files larger than disk size to other
  163.             computers.
  164.  
  165.         **  Start with a specific file in a directory.
  166.  
  167.         **  End with a specific file in a directory.
  168.  
  169.         **  Process files based on the date stored in its directory
  170.             entry.
  171.                                                                 Page  4
  172.  
  173.         **  Warns you before overlaying a file unless specific
  174.             parameters indicating otherwise are specified.
  175.  
  176.         **  Checks target disk for available space before starting
  177.             to copy files.  This prevents time from being wasted
  178.             when the copy will not be able to complete.
  179.  
  180.         **  Gives you constant status of the progress of the
  181.             command.
  182.  
  183.         **  Runs with windows or using standard DOS screen output.
  184.  
  185.         **  Format new floppy disks as they are needed by pressing
  186.             <F3> at any prompt.
  187.  
  188.         **  Process one directory, a single directory subtree or
  189.             all directories on a disk (/S).
  190.  
  191.         **  Allows you to indicate that multiple input disks are
  192.             to be used and prompts for the next one after each
  193.             disk is processed.
  194.                                                                 Page  5
  195.  
  196.       Command Mode Parameters
  197.       -----------------------
  198.  
  199.       PCOPY allows several command parameter switches to be specified
  200.       to qualify the copy criteria.  All these parameters are
  201.       optional.  The PCOPY command is used like DOS COPY except for
  202.       these switches.  The command format and switch parameters are
  203.       described below.  A quick review of command parameters is always
  204.       available by entering the PCOPY command without any parameters.
  205.  
  206.  
  207.       COMMAND FORMAT:
  208.  
  209.       PCOPY from_file_spec [to_file_spec] [ (/ switches) ]
  210.  
  211.  
  212.       [from}    Enter the DOS file specification for the directory and
  213.                 file names to be moved.
  214.  
  215.                 The filename portion of the file specification may
  216.                 contain wildcard characters documented by DOS (* and
  217.                 ?).
  218.  
  219.  
  220.       [to]      Enter the DOS file specification for the directory and
  221.                 filename to be copied to.  If the "to" specification
  222.                 is not entered, files will be moved to the current
  223.                 directory.
  224.  
  225.  
  226.       /A        Archive - Selects only files that have been marked
  227.                 updated by DOS.  This flag is updated by DOS whenever
  228.                 a files is processed with an intent to change or
  229.                 create new data.
  230.  
  231.  
  232.       /B        BACKUP - When specified, the DOS Archive (Update)
  233.                 flag is reset after a file has been copied.
  234.  
  235.  
  236.       /C        Copy only.  Do not delete the file after it is copied.
  237.                 Only to be used with the PMOVE program.
  238.                                                                 Page  6
  239.  
  240.  
  241.       /D:[(]xxx Date.  Select files based on the relationship between
  242.          [)]    their last update date and the date specified.  This
  243.          [=]    parameter includes a date or number of days value.
  244.                 It may also contain a modifier that reverses or
  245.                 modifies the use of the date specified.
  246.  
  247.                 When xxx contains a date the date is compared to the
  248.                 last update date of the file.  The last update date
  249.                 of the file is the date contained in its directory
  250.                 entry.  The file is selected if the condition specified
  251.                 by the condition modifier is met.  The condition
  252.                 modifier meanings are:
  253.  
  254.                   '(' =  Select files whose date is older than the
  255.                          date specified.
  256.  
  257.                   ')' =  Select files whose date is newer than the
  258.                          date specified.
  259.  
  260.                   '=' =  Select files whose date is equal to the date
  261.                          specified.
  262.  
  263.                 If the condition modifier is not specified, ')' is
  264.                 assumed.
  265.  
  266.                 Date values may be specified in any of the following
  267.                 formats:
  268.  
  269.                     MM/DD/YY   MM-DD-YY   DDMMMYY
  270.                     12/31/80   12-31-80   31DEC80
  271.  
  272.                 If xxx contains a numeric value, that positive number
  273.                 is used to calculate a date value a number of days
  274.                 prior to the current date.  Then that date is used
  275.                 as in the calculation above.
  276.  
  277.                 Example:
  278.  
  279.                 /D:(1JAN86  - Process files updated before 1JAN86
  280.                 /D:)1JAN86  - Process files updated after 1JAN86
  281.                 /D:=1JAN86  - Process files updated 1JAN86
  282.                 /D:(5  - Process files modified prior to 5 days ago
  283.                 /D:)5  - Process files modified within the last 5 days
  284.                 /D:=5  - Process files modified 5 days ago
  285.  
  286.  
  287.       /D-       Delete all files on target drive before starting copy.
  288.                                                                 Page  7
  289.  
  290.  
  291.       /DC       Directory Copy - When specified, the file is copied
  292.                 to a directory with the same name on the target disk
  293.                 volume.  Only use this parameter when copying data
  294.                 to a new disk drive.  See also the /S option.
  295.                 This is useful for copying all files and directories
  296.                 from one disk to another.
  297.  
  298.                 If the target directory does not exist it will
  299.                 automatically be created.
  300.  
  301.                 If target path is specified, the source path will
  302.                 be added to the target pathname.  Use target
  303.                 pathname of \ to copy directory names as is.
  304.  
  305.  
  306.       /DL       Same as /DC except that only the Last node of the
  307.                 source directory is copied to the target pathname
  308.                 to be generated.
  309.  
  310.  
  311.       /E        Select and move only files that exist on both the "from"
  312.                 and "to" directories.  This causes all duplicate named
  313.                 files to be replaced.
  314.  
  315.  
  316.       /F:file   First.  Indicates that processing is not to start until
  317.                 the specified full filename is encountered in the
  318.                 scan of the directory.
  319.  
  320.                 This parameter is most useful in restarting a
  321.                 move or copy from a location where it had
  322.                 previously left off.
  323.  
  324.  
  325.       /L:file   Last.  Indicates that processing is to stop after
  326.                 the specified full filename is encountered in the
  327.                 scan of the directory. The file specified will be
  328.                 processed if it matches selection criteria.
  329.  
  330.  
  331.       /M        Stop screen from scrolling from scrolling past the end
  332.                 without user intervention (MORE).
  333.                                                                 Page  8
  334.  
  335.       /ME       MErge -- Works like using /U and /X parameter to move
  336.                 most current files from one directory into another.
  337.                 In addition, it deletes all the files that are not
  338.                 moved to the new location.  This has the effect of
  339.                 merging the most current files from two directories
  340.                 into a single directory.
  341.  
  342.  
  343.       /MU       MUltiple input disk are to be processed.  After
  344.                 the first input disk is processed the user is asked
  345.                 if another disk is to be processed.  If Yes is the
  346.                 response processing will continue like the first
  347.                 volume.
  348.  
  349.  
  350.       /N        Only move files that do not already exist on the target
  351.                 directory. (New files).  If the file already exists,
  352.                 no attempt will be made to move it and no warning
  353.                 message will be printed.
  354.  
  355.  
  356.       /NW       No Windows - Do not use windows during processing.
  357.                 All screen output will be done through standard DOS
  358.                 facilities.
  359.  
  360.  
  361.       /O        Omit files from processing.  This option reverses the
  362.                 purpose of the source filespec in the command.  Instead
  363.                 if selecting those files, all files except those
  364.                 matching the filespec will be selected.
  365.  
  366.  
  367.       /P        Pause before each file is moved and ask for approval
  368.                 to process it.
  369.  
  370.  
  371.       /R        Replace any duplicate files on the target disk or
  372.                 directory regardless of their dates.
  373.  
  374.  
  375.       /RE       REgister the program.  Use this option to register
  376.                 your copy of the utility.  You will need to have
  377.                 the registration number and code that is sent to
  378.                 you when you ask to be registered.
  379.  
  380.                 Part of the registration screen also allows you
  381.                 to permanently modify the windows option.  If you
  382.                 do not want windows during processing use this
  383.                 option to change the windows program option.  You
  384.                 do not need to be registered to change this
  385.                 information.
  386.                                                                 Page  9
  387.  
  388.  
  389.       /RO       Read-Only.  Normally processing skips files marked
  390.                 with the DOS Read-Only attribute.  Using /RO causes
  391.                 Read-Only files to also be selected for processing.
  392.  
  393.  
  394.       /S        System -- If a source directory is supplied, that
  395.                 directory and all subordinate directories will be
  396.                 processed.  If no source directory is specified,
  397.                 all directories on the disk will be processed.
  398.  
  399.  
  400.       /SA       SAve -- Instead of overlaying already esisting files
  401.                 with duplicate names,  before the new file is copied,
  402.                 the file in the target directory is renamed with a
  403.                 version.  This insures that no data is possibly lost.
  404.  
  405.                 If the file has an extension name, the last two
  406.                 characters of the extension are replaced with a number
  407.                 from 01 to 99 depending on the next available
  408.                 number.  PCOPY determines the next available number
  409.                 by looking in the directory for other files with
  410.                 similar names.
  411.  
  412.                 This facility can be used to easily save versions of
  413.                 a file in a directory.
  414.  
  415.  
  416.       /SF       System Files.  Normally processing skips files marked
  417.                 with the DOS System attribute.  Using /SF causes
  418.                 System files to also be selected for processing.
  419.  
  420.  
  421.       /SZ: [(] [)]  nnn    Select a file based on its size.  The
  422.                 left paren indicates that files less than the
  423.                 indicated size are to be selected.  The right
  424.                 paren indicates to select files greater than the
  425.                 size.  If right or left paren are not specified,
  426.                 a left paren is assumed.  Following are examples.
  427.  
  428.                 /SZ:100    --  Select files less than 100 characters
  429.                 /SZ:(100   --  Select files less than 100 characters
  430.                 /SZ:)100   --  Select files greater than 100 characters
  431.  
  432.  
  433.       /T        Test the move process.  Use this switch when you
  434.                 would like to test the PMOVE command entered without
  435.                 actually moving any files or creating any directories.
  436.  
  437.                 Messages will indicate what will happen if the command
  438.                 is executed without the /T switch.
  439.                                                                 Page 10
  440.  
  441.  
  442.       /U        Only move files that do not exist on the target
  443.                 directory or duplicate filenames that are newer than
  444.                 their counterparts on the target directory or disk.
  445.  
  446.                 Use of this option results in the most current version
  447.                 of each selected file being at the target location.
  448.  
  449.  
  450.       /V        Verify -- Use the DOS verify option while copying
  451.                 data.  This causes all data to be reread after it
  452.                 is written to disk to insure it was written
  453.                 properly.
  454.  
  455.  
  456.       /X        Move the files.  Delete them after the copy is
  457.                 performed.  If the move is to another directory on the
  458.                 same disk the directory entry for the file is moved
  459.                 without having to move the data.  This provides for
  460.                 the fastest move possible.  Used for PCOPY only.
  461.                                                                 Page 11
  462.  
  463.  
  464.       Examples:
  465.  
  466.       1.  Copy all files in directory \GEN to directory \SAVE
  467.  
  468.              PCOPY \GEN \SAVE
  469.  
  470.  
  471.       2.  Copy all files in directory \GEN to directory \SAVE
  472.  
  473.              PCOPY \GEN \SAVE /C
  474.  
  475.  
  476.       3.  Copy all *.BAT files from current directory to \SAVE
  477.  
  478.              PCOPY *.BAT \SAVE
  479.                    or
  480.              PCOPY *.BAT \SAVE\*.*
  481.  
  482.  
  483.       4.  Move all files in current directory to disk in drive A:
  484.  
  485.              PMOVE *.* A:/X
  486.  
  487.  
  488.       5.  Update directory PAY with more current files from drive A:.
  489.           Save any old versions under generated version name.
  490.  
  491.              PCOPY A:*.* \PAY /R/SA
  492.  
  493.  
  494.       6.  Search hard disk C: for any files ending with .WKS and move
  495.           all the files to a new directory named \WKSDIR.
  496.  
  497.              PCOPY c:*.* c:\WKSDIR /X/S
  498.  
  499.  
  500.       7.  Copy all the files on the hard disk to multiple floppy disks
  501.           to be mounted in drive A:.
  502.  
  503.              PCOPY *.* a: /S
  504.  
  505.                                                                 Page 12
  506.  
  507.  
  508.       Registering PCOPY
  509.       -----------------
  510.  
  511.       PCOPY is distributed under the Shareware concept.  This makes it
  512.       available for anyone to try without obligation.  If you decide it
  513.       is useful and want to keep it, I ask that you register your use
  514.       of it.  This will allow for continued support and maintenance of
  515.       the program and will help to encourage that more quality software
  516.       be made available through this channel.   We require all
  517.       corporate and government users of this utility register their
  518.       copies.
  519.  
  520.       To simply register the program, $15 is requested.  If you would
  521.       like the newest program disk and a copy of the manual send
  522.       $30.  If you would like to register all the Patriquin utilities,
  523.       and receive programs on disk and manuals, send $45.
  524.  
  525.  
  526.       Send registration requests to:
  527.  
  528.                       Norm Patriquin
  529.                       P.O. Box 8308
  530.                       San Bernardino, CA   92412
  531.  
  532.  
  533.       The registration charge is a one time fee that entitles you to
  534.       all future versions of the product.  These may either be obtained
  535.       from normal Shareware sources or directly from me.  Any
  536.       organization ordering more than 100 copies is also entitled to
  537.       telephone support and will be given the technical support number.
  538.  
  539.       Following is a form that may be used to register PCOPY.
  540.  
  541.                                                                 Page 13
  542.  
  543.                               PCOPY Registration
  544.                                  Version 5.1
  545.  
  546.  
  547.       Please Register PCOPY to the following person.  We will use ____
  548.       copies  of  the program and have enclosed $____ for each copy to
  549.       be used.
  550.  
  551.       **************************************************************
  552.  
  553.       _____ Registration code and serial number............   $15.00
  554.  
  555.       _____ Registration, program disk and manual..........   $30.00
  556.  
  557.       _____ Registration of all Patriquin Utilities with
  558.                program disks and manuals...................   $45.00
  559.  
  560.       _____ Update of newest Patriquin Utility disk with
  561.                manual.  ...................................   $15.00
  562.  
  563.       **************************************************************
  564.  
  565.  
  566.       Name: __________________________________________________
  567.  
  568.       Company: _______________________________________________
  569.  
  570.       Address: _______________________________________________
  571.  
  572.                _______________________________________________
  573.  
  574.       City: ______________________________  State: ___________
  575.  
  576.       Zip:  ______________________
  577.  
  578.       I obtained my copy of PCOPY from: ____________________________
  579.  
  580.       If BBS indicate name and number please._________________________
  581.  
  582.       ________________________________________________________________
  583.  
  584.       Please register the software under the following name:
  585.  
  586.       ____________________________________________________
  587.  
  588.               Send to:
  589.                       Norm Patriquin
  590.                       P.O. Box 8308
  591.                       San Bernardino, CA  92412
  592.                                                                 Page 14
  593.                           P C O P Y
  594.  
  595.       Problems and Maintenance
  596.       ------------------------
  597.  
  598.       I welcome all comments or enhancement suggestions. Please
  599.       document each item clearly and provide printed examples if
  600.       possible.  Please be sure to include this form with all requests,
  601.       it will help to make sure we can provide you with the best
  602.       possible service.
  603.  
  604.  
  605.       Name: __________________________________________________________
  606.  
  607.       Company: _______________________________________________________
  608.  
  609.       Address: _______________________________________________________
  610.  
  611.                _______________________________________________________
  612.  
  613.       City: __________________________________  State: _______________
  614.  
  615.       Zip: ______________________________
  616.  
  617.       Telephone: _______ / ________________________ (Home / Work)
  618.  
  619.  
  620.       Date: _________________________
  621.  
  622.       Description of problem or enhancement:
  623.  
  624.       ________________________________________________________________
  625.  
  626.       ________________________________________________________________
  627.  
  628.       ________________________________________________________________
  629.  
  630.       ________________________________________________________________
  631.  
  632.  
  633.       Suggested solution:
  634.  
  635.       ________________________________________________________________
  636.  
  637.       ________________________________________________________________
  638.                                                                 Page 15
  639.  
  640.       Program Maintenance:
  641.  
  642.       Version 1.0
  643.          --  Multiple file move/copy utility with /U /N and /R
  644.              parameters.
  645.  
  646.  
  647.       Version 2.0     June 1986
  648.          --  Added ability to create directory and detect full disks.
  649.  
  650.  
  651.       Version 3.0     August 1986
  652.          --  Window operation added.
  653.  
  654.          --  Improved help.
  655.  
  656.          --  /B  /DC  /D-  /E  /RE  /S  /SA  /SF  /V
  657.  
  658.  
  659.       Version 4.0     August 18, 1986
  660.          --  /ME /SF /RO parameters added.
  661.  
  662.          --  Corrected problem with /DC parameter and directory
  663.              scanning.
  664.  
  665.  
  666.       Version 5.0     October 13, 1986
  667.          --  Corrected /B parameter to reset backup directory
  668.              indicator after file is processed.
  669.  
  670.          --  Added /MU parameter to process multiple input disk
  671.              volumes.
  672.  
  673.          --  Various documentation corrections.  Special thanks
  674.              to Edward Koch for technical editing of the document.
  675.  
  676.          --  Correct /ME parameter.  Merge was deleting the target
  677.              file, not the source.
  678.  
  679.          --  Added selection by size with /SZ:nnn
  680.  
  681.          --  Suspend and execute a DOS command from any question or
  682.              prompt.  Press <F3> to accomplish this.  This is
  683.              particularly useful to format new floppy disks when
  684.              new ones are needed.
  685.  
  686.          --  Process a directory tree if /S is specified and
  687.              a directory name is supplied in the source specification.
  688.              Previous releases would only process a single directory,
  689.              without /S, or the entire disk with the /S parm.
  690.                                                                 Page 16
  691.  
  692.  
  693.       Version 5.1     November 5, 1986
  694.          --  Added complete capability to rename files using DOS
  695.              global characters ? and * in source and target
  696.              specification
  697.  
  698.          --  Extended ability to copy and create new directories.
  699.  
  700.                1.  Allow to copy a directory structure below another
  701.                    structure.
  702.  
  703.                    If directory copy specified /DC and the target
  704.                    directory also has a pathname, the source
  705.                    pathname is added to the target pathname.
  706.  
  707.                2.  Ability to copy a single directory node below
  708.                    an already existing directory structure.
  709.                    Use /DL.
  710.  
  711.                3.  Ability to copy a complete directory substructure
  712.                    with a single command.
  713.  
  714.          --  Problem corrected where ending totals were not updated
  715.              after last file copied.
  716.  
  717.          --  When /R (replace) specified, print messages indicating
  718.              if processed files are newer, older or duplicates of
  719.              overlayed files.
  720.  
  721.